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© Method for comparing and swapping data In a multi-programma data processing system. 



© The method for comparing and swapping data which are located in discontiguous locations in a data 
processing system, comprises the steps of comparing first and second operands which are located in memory, 
and if said first and second operands are equal, loading the value at a fourth operand into a third operand 
located in memory, then setting an indicator in memory that the first and second operands are equal, and 
performing a serialization process on the second operand location prior to the time the second operand is 
fetched, whereby a value is fetched from one location in memory dependent on the fact that the value at another 
location does not change. 
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METHOD FOR COMPARING AND SWAPPING DATA IN A MULTI-PROGRAMMING DATA PROCESSING 

SYSTEM 



The invention relates to the manipulation of time-ordered lists in multiple processing units or multiple 
programmed computing systems, and more particularly a method for comparing and swapping data 
enabling the addition or deletion of items without a locking mechanism, even when multiple processing units 
have asynchronous access to the lists. 

5 The invention deals with both queues as well as stacks. In a queue, also termed a FIFO (first-in, first- 
out) list, the first item added to the list is the first to be removed. In a stack, also termed a LIFO (last-in, 
last-out) list, the last item added to the list is the first to be removed. Asynchronous manipulation of FIFO 
and LIFO lists is very common in operating system and sub-systems environments. The limitations imposed 
on these environments by the inability to quickly and easily manipulate time-ordered lists are becoming 

w excessive. As the number of processors used in tightly coupled complexes continues to increase, the cost 
of serialization by software will also increase. Because of the high utilization of time-ordered lists, this cost 
is becoming prohibitively expensive. 

Currently, there are two common methods of maintaining a FIFO list. For a single headed queue, the 
list is defined as having one anchor point all elements are added using this point and are deleted by 

;s searching down the list and removing the last element. This method allows for multiple adders, but only a 
single deleter. It also requires that the deleter searches to the end of the list, which may cause the deleter 
to be interrupted by page faults. The overhead associated with page faults that may be incurred can 
become excessive with long lists. 

For a double headed queue, the list is defined as having two anchor points, and all elements are added 

20 using one point and deleted using the other. This second method only allows one adder or deleter to be 
accessing the list at a time. To assure that only one access is allowed at a time, some method of 
serialization (a locking mechanism) must be employed. 

The first method may be impractical because of the performance implications of excessive paging. The 
second method has the restriction that a lock must be used; this requirement can also contribute to 

25 performance degradation. 

The most common technique of monitoring a LIFO list Is to set one anchor point in a stack and adding 
(pushing) and deleting (popping) all elements using this anchor point. The IBM System/370 Extended 
Architecture Principles of Operation, (IBM Publication No. SA22-7085-0). hereinafter referred to as the 
370XA Prin. Ops on page A45, gives the example of providing for multiple asynchronous unlocked adders 

30 and deleters. 

Other specific examples of prior art systems and methods include U.S. patents 4,394,727 and 
4,320,455, and the article by Conroy in the IBM Technical Disclosure Bulletin, Vol. 24, Nov. 1981. pages 
2716 to 2723, all of which involve the use of a lock bit or lock word. 

One technique for avoiding the use of locking mechanisms in some instances in multi-processing or 

35 multiprogrammed computing systems is described in US Patent 3,886,525. This technique includes the 
invention of a new instruction at that time called "Compare and Swap." Using this instruction, each user of 
shared data is permitted to access it at its addressable location in the shared data store for further 
processing by the sequence of program instructions. After processing, the processed data is to be returned 
to the address location of the shared data. Prior to returning the processed data to the address location in 

40 the shared data store, the new instruction is accessed in the sequence of instructions. Using "Compare and 
Swap," the data content of the addressed location accessed by the instruction is compared with the data 
accessed from the addressed location prior to the processing. As a result of this comparison, it can be 
determined that during the period of processing on the shared data, another user has or has not also 
accessed the shared data for processing, and returned a different value of the shared data back to the 

45 addressed storage location. If, in response to the "Compare and Swap" (CS) instruction, it is determined 
that the value of the addressed location has been modified by another user, the modified value is retained 
by the user and the processing is reinitiated on the modified value. If the value of the data in the addressed 
location accessed by the CS instruction is still identical to the value of the data accessed by the user prior 
to processing, it can be determined that no other user had accessed shared data and modified it. Therefore, 

so the processed data will be transferred to the addressed location and further processing permitted. 

The "Compare and Swap" (CS) and its companion "Compare Double and Swap" (CDS) instructions are 
now used in multi-programming and multi-processing environments to serialize access to counters, flags, 
control words and other common storage areas. The 370XA Prin. Ops shows a sample of the use of CS and 
CDS instructions. Probably the most significant point to note is that functions can be performed by 
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programs running enabled for interruption (multi-programming) or by programs that are running on a multi- 
processing configuration. In other words, the instructions CS and CDS allow a program to modify the 
contents of a storage location while running enabled, even though the routine may be interrupted by another 
program on the same CPU that will update the location, and even though the possibility exists that another 

5 CPU may simultaneously update the same location. 

The CS instruction first checks the value of a storage location and then modifies it only if the value is 
what the program expects; normally, this would be a previously fetched value. If the value in storage is not 
what the program expects, then the location is not modified; instead, the current value of the location is 
loaded into a general register in preparation for the program to loop back and try again. During the 

io execution of CS, no other CPU can access the specified location. 

When a common storage area larger than a doubleword is to be updated, it is usually necessary to 
provide special interlocks to ensure that a single program at a time updates a common area. Such an area 
is called a serially reusable resource (SRR). In general, updating a list or even scanning a list, cannot be 
safely accomplished without locking the list. However, the CS instructions can be used in certain restricted 

is situations to perform the lock/unlock functions and to provide sufficient queuing to resolve contentions, 
either In a UFO or FIFO manner. A lock/unlock function can then be used as the interlock mechanism for 
updating an SRR of any complexity. 

The lock/unlock functions are based on the use of a "header" associated with the SRR. The header is 
the common starting point for determining the states of the SRR, either free or in use, and also is used for 

20 queuing requests when contentions occur. Contentions are resolved using "Wait and post". The general 
programming technique requires the program that encounters a "lock" SRR must "leave a mark on the 
wall," indicating the address of an ECB on which it will Wait. The "unlocking program" sees the mark and 
Posts the ECB, thereby permitting the Waiting program to continue. In most cases, all programs using a 
particular SRR must use either the UFO queuing scheme or the FIFO scheme; the two are not mixed. 

25 When more complex queuing is required, the suggestion in the 370 XA Prin. Ops manual is that the queue 
for the SRR delocks using one of the two methods shown. 

As noted, the CS & CDS instructions have been used quite successfully. They enable users to obtain 
access to shared data or headers for the purpose of further processing. The need to prevent access to the 
addressed location when another user is processing data is eliminated by the CS instruction. However, the 

30 CS and CDS instructions apply only to a single word or a double word. 

In contrast, as will be explained, the "Compare and Swap Disjoint" (CSD) and "Compare and Load" 
. (CAL) instructions of this invention enable the referencing of two non-adjacent words (or double words in an 
expanded version). 

It is therefore an object of the invention to allow unlocked asynchronous access to lists by multiple 
35 processing units or users, while maintaining the integrity of the lists. 

The object of the invention is achieved by novel procedures which include the creation of novel 
computer instructions, viz., "Compare and Swap Disjoint" and "Compare and Load." The use of these 
memory-access-serialization instructions allows unlimited asynchronous manipulation of these lists by any 
number of adders and deleters. The method also allows the addition and deletion of elements to a time- 
40 ordered list of either FIFO or LIFO types by multiple processors while maintaining list integrity. The term 
"disjoint" means that the two words being acted upon are not adjacent to each other in storage. Another 
term for "disjoint" is "discontiguous". 

The novel "Compare and Load" (CAL) instruction compares data in a first register with an address 
location and fetches into a second register the value from a second location based on the equality of the 
45 comparison. The advantage of this is that one can fetch a value from a location dependent on the fact that 
the contents of another location have not changed. 

The novel "Compare and Swap Disjoint" (CSD), as distinguished from the "Compare and Swap" (CS) 
instruction and the "Compare Double and Swap" (CDS) instructions, enables the program to refer to two 
non-adjacent words or double words; i.e., it allows for the simultaneous updating of two disjoint 
so (discontiguous) storage locations. This aids in list manipulation because one must deal with two disjoint 
entities in many practical situations. 

A preferred embodiment of the invention is now described in reference to the accompanying drawings 
wherein ; 

Fig. 1 is a flow diagram showing the operation of the novel "Compare and Load" instruction. 
55 Fig. 2 Is a flow diagram showing the operation of the novel "Compare and Swap Disjoint" instruction. 

Fig. 3 illustrates a double-headed queue FIFO list and the result obtained after the manipulation of 
the list by the invention. 

Figs. 4A and 4B are flow diagrams illustrating the method according to the invention of deleting an 
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element from the double-headed queue shown in Fig. 3. 

Fig. 5 illustrates adding an element to a double-headed queue in accordance with the invention. 
Fig. 6 is a flow diagram showing the method of enqueueing the elements of Fig. 5. 
Fig. 7 illustrates a LIFO queue list and the result obtained after the manipulation of the list by the 
5 invention. 

Fig. 8 is a flow diagram illustrating the method according to the invention of deleting an element from 
the stack shown in Fig. 7. 

The specification begins with the description of the two novel instructions and their operation "Compare 
and Load" and "Compare and Swap Disjoint." The instructions are written in the format of the 370-XA Prin. 
w Ops. but the methods have more general applications. COMPARE AND LOAD ("CAL"); R1 ,02(82)^3,04- 
(B4) 



0P # 


R1 


R3 


B2 


D2 


B4 


04 



0 8 12 16 20 32 36 47 



20 The foregoing description is set forth in relation to Fig. 1 of the drawing and the CAL format. 

The addressable data specified by the Compare and Load instruction is depicted as follows 
The operation code in binary bits 0-7 will be decoded to signify the Compare and Load instruction. Four 
different operands are identified by address information in the remaining portions of the instruction. The five 
binary bits 8-11. designated R1, identify a general purpose register containing operand 1. The binary bits 

25 12-15, designated R3, identify the general purpose register containing the processed data or operand 3. 
Binary bits 16-19, labeled B2 f identify a general purpose register which contains base address information 
to which binary bits 20-31 of the instruction, labeled D2, are added to identify the addressed location in 
shared storage. Binary bits 32-35,. labeled B4, identify a general purpose register which contains base 
address information to which binary bits 36-47, labeled D4, are added to identify the addressed location in 

30 shared storage. 

In block 30, Compare_Value is Operand 1, R1, Compare Location is Operand 2, D2(B2), Fetch_Value 
is Operand 3, R3 and Fetch_Location is Operand 4, D4(B4). As will be discussed with respect to the queue 
manipulation processes, the two discontiguous or disjoint elements are, e.g., the head of a list and another 
element in the list. 

35 The fullword at the second-operand location in storage D2(B2) is compared with the first operand in R1 
as shown in block 32 in Fig. 1. If they are equal, then the program fetches into the register the third 
operand R3, the fullword at the location defined by the fourth operand D4(B4) in storage as the 
base/displacement as shown in block 34. The Condition Code is set to 0 as shown in block 4. 

In decision block 32, if the fullword at the second-operand location is not equal to the first operand, then 
40 the first operand is set equal to the second operand, the third operand remains unchanged, as shown in 
block 36, the fourth operand is not used; and the condition code (CC) is set to 1 , as shown in block 38. 

R1 and R3 each represent any general register means. The second and fourth operands are fullwords 
in storage designated on a word boundary. 

Access exceptions are not recognized against the fourth operand if the second operand is not equal to 
45 the first. (In other words, no reference to the fourth operand location is made.) 

When the second operand D2(B2) in storage is equal to the first operand in R1, no access by another 
CPU to the second operand is permitted between the moment that the second operand is fetched and the 
fourth operand is fetched. This type of step is commonly referred to as storage access serialization. 

Serialization on each operand location is performed in step 32 before the value in that location is 
so fetched, and again after the operation is completed. CPU operation is delayed until all previous accesses by 
this CPU to storage have been completed, as observed by channels and other CPUs, and then the second 
operand is fetched, if the comparison of the first and second operands are equal, then the fourth operand 
(D4)B4 is fetched. No subsequent instructions or their operands are accessed by this CPU until the 
execution of the CAL instruction is completed. 

55 

Resulting Condition Code (CC): 
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0 First and second operands are equal, and the third operand has been replaced by the fourth 
operand. 

1 First and second operands are unequal. The first operand has been replaced by the second 
operand. The third and fourth operands are unchanged. 

5 2 ~ 

3 

Program Exceptions 

w - Access (fetch and store operands 2 and 4) ' 
• Operation 

- COMPARE AND SWAP DISJOINT (CSD) 
CSO R1,D2(B2),R3,D4(B4) 



"OP* 


R1 


R3 


B2 


D2 


B4 


D4 



0 8 12 18 20 32 38 47 



20 

Referring to Fig. 2, the CSD process begins in block 50 with the general purpose being to compare the 
first and second operands and then the third and fourth operands under certain conditions. The first 
operand R1 and the second operand D2(B2) In storage are compared in decision block 52. If they are 
25 equal, the third operand in R3 and fourth operand D4(B4) in storage are compared in decision block 58. If 
they are also equal, the R1 + 1 operand (Replace Value 1) is stored at the second operand location 
(location_l), and the R3 + 1 operand (Replace_Vafue_2) is stored at the fourth operand location as 
shown in block 64. The Condition Code is set to 0 as shown in block 66. 

If the first operand R1 and the second operands D2(B2) are unequal, the second operand is loaded into 
30 the first operand in block 54. If the first and second operands are equal, and the third and fourth operands 
are unequal as decided in block 58, the fourth operand is loaded into the third operand as shown in block 
60. The CC is set to 2 as shown in block 62. 

R1 and R3 each represent an even-odd pair of general registers and designate an even-numbered 
register. R1 +1 and R3 + 1 represent the odd-numbered register of the pair. The second operand D2(B2) 
35 and fourth operand D4(B4) are words in storage. 

When the result of the comparison of the first and second operands is unequal, the second operand 
remains unchanged, and the fourth operand is not accessed. When the result of the comparison of the third 
and fourth operands is unequal, the second and fourth operands remain unchanged. Access exceptions are 
not recognized against the fourth operand if the first and second operands are unequal. 
40 When both comparisons done in blocks 52 and 58 are equal, no access by another CPU to the second- 
operand or fourth-operand location is permitted between the moment that the respective operand is fetched 
for comparison and when it is stored. 

Serialization on each operand location is performed before it is fetched in blocks 52 and 58, and again 
after the operation is completed at block 68. CPU operation is delayed until ail previous accesses by this 
45 CPU to storage have been completed, as observed by channels and other CPUs, and then the second 
operand is fetched at block 52. 

If the first and second operands are equal, then the fourth operand is fetched at block 58. No 
subsequent instructions or their operands are accessed by this CPU until the execution of the CSD 
instruction is completed, including placing the result values, if any, in storage, as observed by channels and 
so other CPUs. 

The second and fourth operands are designated on a word boundary. The R1 and R3 fields each 
designate an even register. Otherwise, a specification exception is recognized. 



55 Resulting CC: 

0 First and second operands are equal, and third and fourth operands are equal. The second and fourth 
operands have been replaced. 
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1 First and second operands are unequal. The first operand has been replaced by the second operand. 
The third and fourth operands are unchanged. 

2 First and second operands are equal, but the third and fourth operands are unequal. The third 
operand has been replaced by the fourth operand. The first and second operands are unchanged. 

5 3 

Program Exceptions : 

- Access (fetch and store, operands 2 and 4) 
w - Specification 

- Operation 

Now, the following illustrates of how the novel instructions may be productively used in the manipulation 
of time-ordered lists or queues. The queue is defined as having head and tail pointers. The elements are 
added to the tail and taken from the head of the queue. Fig. 3 illustrates the deletion of an element from a 

/5 double-headed queue. As stated, the queue is defined as having Q_head (Q_head) and Q_tail (Q tail) 

where the Q_head points to the newest element in the queue and the Q_tail points to the oldest element 
in the queue. The solid lines show the list as it exists before it is manipulated. Given a representative queue 
with elements added in this order, A, B and C, to effect the deletion of element A. the Q_head pointer must 
be changed to point to element B as shown by the dotted line. 

20 The method of accomplishing this in accordance with the invention is illustrated in Figs. 4A and 4B and 
in that portion of instructions in Table II in this specification which relate to DEQUEUEING. 

The queue is defined as having head and tail pointers. The elements are added to the tail and taken 
from the head of the queue. 

The principal result of the method enables the replacement of the pointer in the Q_head and the 
25 replacement of the next pointer in element A without any possibility of modifications. This ensures that list 
integrity is maintained during the manipulation of the list. 



LIST MANIPULATION 

30 

Following is a detailed description of allowing multiple processes to DEQUEUE and ENQUEUE 
elements concurrently, without having to hold a lock or to wait on an event control block (ECB), while still 
ensuring that the queue will not be corrupted. This is achieved by including the CAL and CSD instructions 
in the programs. 

35 The QUEUE is defined as having Head and Tail pointers. The elements are added to the tail and taken 
from of the head of the queue. The functional definition is the same as a double headed queue in Figs. 3 
and 4. See the 370/XA Prin. Ops. for a description of the instructions used below. 
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Assume the following declarations: 



w 



15 



1. QUEUE DS OF 

2. QUE AD DC A(0) 

3. QTAIL DC A(0) 

4. * 

5 . ELEMENT DSECT 

6. NEXT DS A 

7. ELEMENTL EQU *- ELEMENT 

8. * 

9. NEWELEM DS CL( ELEMENTL) A new element to add to the Queue 



Pointer to the head of the queue 
Pointer to the tail of the queue 

A Queue Element 

Pointer to the next element on the queue 
Length of ELEMENT 



20 



25 



DEQUEUE ing an element from the QUEUE. (Refer to Fig. 4 for the flow 
diagram, ) 



30 



35 



1. DEQUEUE L 

2. DEQ1 LTR 

3. BZ 

4. CAL 

5. BC 



6. DEQ2 



LTR 
BNZ 



R2, QHEAD Get the pointer to Head 

R2,R2 Anything there? (Load and Test) 

DEQEXIT No, so exit 

R2, QHEAD, R4,NEXT-ELEMENT(R2) Set R'i QHEAD (§NEXT 

4,DEQ1 QHEAD changed, so try again 

R4,R4 Was the first element the only element? 

DEQ3 No, So Dequeue with CSD 



40 



45 



SO 
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8. 




LR 


R5.R4 


Yes, R5=R4=0 


9. 




T.R 


R3.R2 


The. Tail MUST equal the Hend pointer 


10. 




CDS 


R2,R4, QUEUE 


Replace the queue pointers with zero 


n. 




nc 


4,DEQ1 


If it didn't work, th«»n try again 


12. 




B 


DEQEXIT 


It worked, so indicate success and exit 


13. 


DF.Q3 


T.R 


R3.R4 


Use the NEXT field to replace the QHEAD 


14. 




SLR 


R5.R5 


Replace the Next field with zero 


15. 




CSD 


R2. QHEAD, R4, 


,NEXT-ELEMENT(R2) Update pointers 


16. 




BC 


4.DEQ1 


R2 =QHEAD, try again 


17. 




BC 


2.DEQ2 


R4 =NEXT, try again 


18. 


DEQEXIT DS 


OH 


If DEQUEUEd R2=Element ELSE R2=0 



20 



25 



ENQUEUE ing an element to the QUEUE. 
(Refer to Fig. 6 for the flow diagram.) 
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35 



40 



45 



50 
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1. 


ENQUE 


LA 


R5 , NEWELEM 


Get the address of the new element 


2. 


ENQt 


LM 


R2,R3, QUEUE 


Get the QHEAD & QTAIL pointers 


3. 




LTR 


R2,R2 


Is there anything on the QUEUE 


4. 




BNZ 


ENQ2 


Yes, so do normal enqueue 


5. 




LR 


R4.R5 


No, QHEAD & QTAIL must point 
to the New Element 


6. 




ens 


R2.R4, QUEUE 


Update the pointers 


7. 




BC 


4.ENQ1 


It didn't work, so try it again 


8. 




B 


ENQEXIT 


It did work, so exit 


9. 


ENQ2 


LR 


R2.R3 


Pointer to Tail of QUEUE 


10. 




LR 


R3,R5 


Pointer to New Element 


U. 




SLR 


R4.R4 


Current Tail Element has a 
zero NEXT pointer 


12. 




CSD 


R2 , QTA I L , R4 , NEXT -ELEMENT( R2 ) Update the pointers 


13. 




BNZ 


ENQ1 


It didn't work, try again 


14. 


ENQEXIT DS 


QK 





Turning now to Rg. 4A, the program, DEQUEUE, removes an element from a double-headed FIFO list 
in accordance with my invention. The first step in the program, as shown in block 231, is to atomically load 

the Q_head and Q tail with elements if there are any to be loaded. The program proceeds to block 232 to 

decide whether the queue is empty. If the answer is yes, the dequeue program is exited as shown in block 
233. If the answer is no, the Compare and Load routine in block 234 is used to fetch the value of the next 
pointer from the oldest work element while making sure the Q_head does not change. 

The next step in the process is to determine whether the Q_head pointer had changed as shown in 
decision block 235. If the answer is yes, the routine returns to decision block 232 to try to dequeue the next 
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element 

CAL is used to fetch the value of the next pointer from the first element on the chain as addressed by 
the Q_head. This operation is performed while ensuring that that element has not been removed by 
another process executing the same CAL or dequeue operation. If it is detected that the Q_head has 

5 changed, which indicates that someone else has removed an element from the list, then the program must 
refetch the next query location as described above. If in fact the Q_head did not change, then the program 
does hold a valid next pointer location. 

The next step in the process is to test the next pointer fetched according to block 234. If the next 
pointer was not zero, then more than one element exists, as determined in block 236, and the program then 

10 sets the replacement value for the Q_head to the next pointer fetched in block 234. In block 237 the 
program sets the Q_ tail value to the same value as the Q_head value. While making sure the Q_Jiead 

and Q_teil do not change (atomically), the Q_head and Q tail are replaced with zeros. If, on the other 

hand, the Q_head or Q tail changed, the program returns to block 232 to test the Q_head again. If the 

Q_head and Q taii did not change, then the program is exited with either zero or the address of the 

75 dequeued element as shown in block 243. 

Turning to block 240 in Fig. 4B, while ensuring that the Q_head and next field do not change, the 
program replaces the value of the Q_head with the value of the second oldest element on the queue and 
replaces the value of the next pointer to zero. As indicated in the drawing, this is the use of the Compare 
and Swap Disjoint (CSD) instruction. In decision block 241 a decision is made as to whether the Q_head 

20 pointer had changed. If the pointer had changed the program returns to decision block 232 to determine 
whether or not the queue is empty. If the Q_head pointer had not changed, the program proceeds to 
decision block 242. The dequeue routine is exited as shown in block 243. This exit occurs with either zero 
or the address of the dequeued element. 

Returning to decision block 236, if there had been only one element in the queue and if the Q_head 

25 and Q_teil have not changed since loading, then they are both set to zero. The program then proceeds to 

decision block 238 to determine whether the Q_head and Q tail changed. If the Q_head and Q tail had 

changed, the process returns to step 232 to determine if the queue is empty. However, if the Q__head and 
Q_tail had not changed, the program is exited with the address of the dequeued element. 

In using the CSD, the DEQUEUE program replaces the value of the Q_head and the value of the next 

30 pointer location on the first element of the chain, ensuring that they have not changed. CSD then replaces 
them with the address of the second element on the chain and with zero, respectively, ensuring that both 
the CMiead and the next pointer have not changed. 

If the CMiead pointer changed or the next pointer changed, that indicate that either another element 
was added to the chain or during the time between the CAL and the CSD that someone else has removed 

35 an element from this queue. At that point the program reperforms the CAL instruction as shown above. If 
neither pointer changed, then the first element on the queue has now been removed and the process is 
successful. 

Fig. 5 illustrates the addition of an element to a double-headed queue. The queue is defined as having 
a Q_ head and a CMail, where the CMiead points to the oldest element in the queue and the CMail 
40 points to the newest element in the queue. Given a representative queue with elements added in this order: 
A, B and C, to effect the addition of element N, the Q_teii pointer must be changed to point to element N 
and the pointer from element C (C next pointer) must be changed to also point to element N. 

Fig. 6 is a flow chart of this a novel method of enqueueing. The example in this case is to add an 
element to a double-Jieaded FIFO list as illustrated schematically In Fig. 
45 5. The detailed set of instructions relating to the flow diagram of Fig. 6 are in the second part of Table 
1. 

As shown in block 100, the Q_head and the CMail pointers are fetched atomically. In decision block 
102 the Q_head is tested to determine whether the queue is empty. If the queue is not empty, the program 
proceeds to block 106 where a new element is added to a non-empty list. The address of the CMail and 

so the address of the new element is established. A register means is used to ensure that the last element 
stays as the last element in the queue. The program next proceeds to decision block 108 where a decision 
is made whether the CMail or the next pointer have changed. If neither has changed, the program exits the 
enqueue routine, if the (Mail or next pointer has changed, the program returns to block 100 and the 
program begins again at that point. If neither the CMail nor the next pointer changed, that means that a 

55 new element has been successfully added to the queue and the program exits enqueue as shown in block 
112. 

If the result from decision block 108 indicates that the CMail or the next pointer of the last element has 
changed since being fetched, the process must start again at block 100. If the answer is no, the queueing 
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process is complete and the program is exited at block 112. 

Returning now to block 102, if the queue is empty, the program proceeds to block 104. A new element 

is added, and both the Q_head and Q tail pointers point to the new element as shown in block 104. As 

shown in the flow diagram, this step is done atomically as the word has been defined in this specification. In 

block 110, a decision is made as to whether contents of the Q_head and Q tsul have changed since 

pointing to the new element. As shown in decision block 110, if they have not changed, the program exits 
the enqueue routine. If the Q_tail or the next pointer of the last element did change, the program returns to 
block 100 to start the procedure again. 

To recapitulate, block 106 represents the CSD instruction, which ensures that while the Q tail pointer 

still points to element C, the CSD instruction compares register operand 1 with location operand 3. If they 
are equal, the program replaces the value in location operand 3 with the value in register operand 2. If they 
are not equal, then register operand 1 gets the value at location operand 3 and the condition code is set. 

Note what the CSD instruction does in comparison with the CS and its companion compare double and 
swap instructions. Compare and Swap and Compare Double and Swap compares and replaces one 
location, either a fullword or a doubleword respectively at that one location. CSD and its companion 
Compare Double and Swap Disjoint will conditionally replace two disjoint elements, either a fullword or a 
doubleword, respectively at two disjoint locations. Compare and Swap compares only one storage location 
and replaces that storage conditionally whereas Compare and Swap Disjoint will compare one location, then 
compare a second location conditional on the equality of the first location; if both of the quality conditions 
are met, then both; locations are replaced. The advantage of this is that one can manipulate both the queue 
or stack and also the first element in the list at the same time while maintaining list integrity (absence of list 
integrity means that an element could be lost, for example). 



List Manipulation of a Stack (a LIFO List) 



Fig. 7 illustrates the removal of an element from a Stack, where the process removes element A from 
the stack. 

The stack is defined as having a TOS (Top of Stack pointer). The elements are added to the TOS and 
taken off from the TOS. 

Given a Stack represented by a top of stack pointer (TOS) and a representative selectino of elements 
A, B and C which were pushed onto the stack in the order of C, B, A, to remove (or pop) the first element 
from the stack you replace the value in the top of stack with the address of B, the second element in the 
stack, and return the value of the address of A. 

The technique allows multiple processes to POP (remove from the stack) elements concurrently, 
without having to hold a lock, or wait on an ECB and all without any possibility that the Stack will be 
corrupted. The technique is described in Table 2 and in Fig. 8. 
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TAPIRS 2 

Assume the following declarations: 

1. STACK DS OF 

2. TOS DC A(0) Pointer to the top of the stack 

3. * 

4. ELEMENT DSECT A Stack Element 

5. NEXT DS A Pointer to the next element on the stack 

6. ELEMENTL EQU *- ELEMENT Length of ELEMENT 
T5 7. * 

8. NEWELEM DS CL( ELEMENTL) A new element to add to the Stack 
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POPing an Element from the STACK. (Refer to Figure 8 for 
the flow diagram.) 
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40 

Fig. 8 is a flow chart of removing an element from a LIFO list. In the first step the address of the top of 
the stack (TOS) is fetched as shown in block 72. In decision block 74 the top of the stack is tested to 
determine whether it is empty or has a value. If the stack is empty, the POP program is exited at 76 since 
45 there is nothing to remove. 

However, if the stack is not empty, the Compare and Load (CAL) instruction in block 78 is used to fetch 
the value of the next pointer from the newest element while making sure that the top of the stack (TOS) 
does not change. If the TOS had changed, as decided in block 82, the program returns to decision block 
74. 

so If the TOS did not change, the program proceeds with the Compare and Swap Disjoint (CSD) instruction 
as shown in block 86. The TOS replacement value is set to the value of the next pointer which had been 
fetched by the CAL instruction in block 78. In block 86 the replacement value for the next field is set to 
zero. While making sure the TOS and the next field do not change, the value of the TOS is replaced with 
the value of the next pointer and the value of the next pointer Is then replaced with zero by the CSD 

55 instruction. 

A decision is made in decision block 79 as to whether the TOS pointer had changed. If the answer is 
yes, the program returns to decision block 74. If the answer is no, a decision is made in block 84 whether 
the next pointer had changed. If the answer is yes, the program returns to the Compare and Swap Disjoint 
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instruction. If the answer from block 84 is no, the POP routine is exited as shown in block 88. The program 
exits either with zero or the address of the element. 

Although the foregoing invention has been particularly shown and described with reference to the 
preferred embodiment thereof, it will be understood by those skilled in the art that other changes in form 
5 may be made without departing from the spirit and scope of the invention. For example, the novel 
instructions can be used on other than IBM System 370 architecture. In addition, the novel instructions may 
be used in processes and apparatus which perform various methods of data processing. 

w Claims 

1. A method for comparing and swapping data which are located in discontiguous locations in a data 
processing system comprising the steps of 

comparing first and second operands which are located in memory, 
is if said first and second operands are equal, loading the value at a fourth operand into a third operand 
located in memory, 

setting an indicator in memory that the first and second operands are equal, and 

performing a serialization process on the second operand location prior to the time the second operand is 
fetched, whereby a value is fetched from one location in memory dependent on the fact that the value at 
20 another location does not change. 

2. The method as in Claim 1 wherein: 

if said first and second operands are unequal, setting the first operand equal to the second operand and 
setting an indicator in memory that the first and second operands are unequal. 

3. The method as in Claim 1 or 2 wherein: 

25 if said first and second operands are equal, said third and fourth operands are compared, and 

if the second comparison is also equal, access by another user to the second operand or fourth operand 
locations is prohibited between the moment that the second and fourth operands are fetched for being 
compared, respectively, and 

if both comparisons are equal, a first replacement operand is stored at the second operand location and a 
30 second replacement operand is stored at the fourth operand location. 

4. The method as in Claim 1, 2 or 3 wherein: 

if said first and second operands are equal, but the third and fourth operands are unequal, setting the third 
operand equal to the fourth operand, and 

setting an indicator in memory for indicating that the third and fourth operands are unequal. 

35 5. The method according to any one of Claims 1 to 4 wherein said data processing system includes a 
plurality of users each of which may require access to the same data in an addressed location of a data 
store for the purpose of processing the data, said method being used to add an element to a double- 
headed FIFO queue by, if the queue is not empty, simultaneously updating the queue tail and the next 
element pointer of the oldest element to point to the new element, and wherein said first operand is the 

40 value of the queue tail, said second operand is the location of the queue tail, said third operand is the next 
element pointer of the oldest element, said fourth operand is the location of the next element pointer of the 
oldest element, and said first and second replacement operands are the location of the new element. 

6. The method as in Claim 5 wherein if the queue is empty, simultaneously updating the queue head 
and queue tail pointers to point to the new element. 

45 7. The method as in Claim 5 or 6 wherein if the queue contains more than one element, simultaneously 
updating the queue head to point to the second newest element, and the next element pointer of the newest 
element to zero and, wherein said first operand is the value of the queue head, said second operand is the 
location of the queue head, said third operand is the next element pointer of the newest element, said fourth 
operand is the location of the next element pointer of the newest element, and said first and second 

so replacement operands are the location of the second newest element. 

8. The method according to any one of Claims 1 to 4 wherein said data processing system includes a 
plurality of users, each of which may require access to the same data in an addressed location of a data 
store for the purpose of processing the data, said method being used to remove an element from a single- 
headed LIFO stack by fetching the address of the second newest element on the stack if the stack is not 

55 empty, and while ensuring the stack does not change, and wherein said first operand is the value of the top- 
of-stack, said second operand is the location of the top-of-stack, said third operand will contain the value of 
second element on completion of the fetch, and said fourth operand is the location of the newest element's 
next element pointer. 
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9. The method as in Claim 8 wherein, if the stack contains more than one element, simultaneously 
updating the top-of-stack to point to the second newest element and the next element pointer of the newest 
element to zero, wherein said third operand is the next element pointer of the newest element, said fourth 
operand is the location of the next element pointer of the newest element, and said first and second 

5 replacement operands are the location of the second newest element. 

10. The method as in Claim 8 or 9 comprising the step of updating the top of the stack to zero if it 
contains only one element. 

11. The method as in Claim 8 or 9 wherein if the stack is empty, returning the value of zero to the user. 

70 
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